home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xblast-1.11 / README < prev    next >
Text File  |  1995-07-14  |  8KB  |  263 lines
  1. Programm XBLAST V1.1 
  2. (C) by Oliver Vogel (e-mail: vogel@ikp.uni-koeln.de)
  3. May 18th 1994
  4. started August 1993
  5.  
  6. File: README
  7.  
  8.  
  9. LICENSE
  10.  
  11. This program is free software; you can redistribute it and/or modify
  12. it under the terms of the GNU General Public Licences as published
  13. by the Free Software Foundation; either version 2; or (at your option)
  14. any later version
  15.  
  16. This program is distributed in the hope that it will be entertaining,
  17. but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. MERCHANTABILTY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19. General Public License for more details.
  20.  
  21. You should have received a copy of the GNU General Public License along
  22. with this program; if not, write to the Free Software Foundation, Inc.
  23. 675 Mass Ave, Cambridge, MA 02139, USA.
  24.  
  25. AUTHOR
  26.  
  27. Oliver Vogel        
  28. vogel@ikp.uni-koeln.de
  29.  
  30. INTRO
  31.  
  32. XBlast is a multi-player arcade game for X11R5/R6. The game can be played
  33. with at least two players and up to four players. It was inspired by
  34. the video/computer game Bomberman(Dynablaster), which was to my
  35. knowledge first programmed for NEC's PC Engine/Turbo Grafx. Other
  36. (commercial) versions of the original game exist for IBM-PC, Amiga,
  37. NES, GameBoy and Super NES.
  38.  
  39.  
  40. FEATURES
  41.  o  2 to 4 players
  42.  o  1 or 2 players per X-Server
  43.  o  Ten different Levels
  44.  o  X11R5 
  45.  o  In this version only monochrome graphics, but grayscale and color
  46.     X-Server are supported
  47.  o  Resolution: 960x688
  48.  o  needs ~200 kB (~280 kB with Backing Store) of X-Server Memory
  49.  o  Compact binary ~180 kB with shared libaries ~350kB with static
  50.     libaries.
  51.  o  Small CPU usage 
  52.  
  53.  
  54. HINT
  55. For descriptions of commandline arguments read the manpage or
  56. type xblast -?. If you start xblast without any option an
  57. interactive setup of game parameters is started.
  58.  
  59. FILES
  60.  
  61. The XBlast package contains the following files:
  62.  
  63.  o  COPYING        - GNU Public License                
  64.  o  INSTALL             - how to install xblast
  65.  o  README              - this file
  66.  o  Levels.HOW          - instruction to create your own levels
  67.  o  Imakefile           - Imakefile for xmkmf
  68.  o  block.c           \
  69.  o  const.h           |
  70.  o  expl.c            |
  71.  o  func.h            |
  72.  o  graphics.c       |
  73.  o  include.h            |
  74.  o  intro.c           >- The source files
  75.  o  main.c        |
  76.  o  maze.c            |
  77.  o  mytypes.h        |
  78.  o  patchlev.h            |
  79.  o  score.c         |
  80.  o  setup.c            |
  81.  o  sprite.c        /
  82.  o  xblast.man          - Manpage
  83.  o  xblast.tcl          - A Setup with X Interface (see below)
  84.  
  85.  
  86. GAMEPLAY
  87.  
  88. The idea of the game is quite simple "There can be only one ...".  So
  89. the aim is to blast away all the other players. You can set the number
  90. of victorious matches required to win the total game with the `-v`
  91. option.  Use your bombs to blast away the other players and certain
  92. blocks (e.g. the ?-Blocks in the 1st level). Under some of these
  93. blocks are extras, which increase the number of bombs you can drop
  94. simultaneously (the bomb symbol) or increase the range of your bombs
  95. (the flame symbol). In higher levels there are other extras like the
  96. skull-symbol which infects the player with a random illness. These
  97. illnesses heal after some time, but while infected the player can also
  98. infect other players. Another extra is the star symbol which makes the
  99. player invincible for some time.
  100.  
  101.  
  102. CONTROL 
  103.  
  104. The number keys 2,4,6,8 (preferably on the number pad) are used to
  105. control the first player of each X-server. If you press one of these
  106. keys the player starts walking in this direction and stops only if
  107. he/she hits an obstacle or the stop key 5 is pressed. In the latter
  108. case the player stops in the middle of the next field. Furthermore you
  109. can change the walking direction by using the direction keys.  If the
  110. key 0 is pressed a bomb is dropped in the middle of the player's
  111. actual field. Be careful not to drop the bomb to early, as you can
  112. block your own way with it (bombs are always blocking the way).
  113. If you have found a remote control (in "Running Man") press +
  114. to ignite your bombs.
  115.  
  116. The second player of the X-Server uses the keys T, F, H, B/V to walk,
  117. SPACE to bomb, G to stop and TAB for remote control. If only one
  118. player uses an X-Server both controls will work for him.
  119.  
  120.  
  121. TESTED PLATFORMS
  122.  
  123. I have tested the actual version program on the following computers
  124.  
  125.   o i486DX266-PC with Linux 1.0
  126.   o DEC 5000/240 with Ultrix 4.2A
  127.   o HP 9000-730S with HP-UX 9.01
  128.   o Motorola MVME-147SA with LynxOS 2.1
  129.   o Sun Sparc 2 with SunOS 4.1.3
  130.   o Force Sparc 2CE with LynxOS 2.1
  131.  
  132. Furthermore older version were compiled by other persons on 
  133. the following machines
  134.  
  135.   o DEC Alpha with OSF/1 Motif
  136.   o SGI workstation IRIX Release 4.0.5 System V
  137.   o IBM RS/6000 with AIX 3.2.4
  138.   o Sparc 10/41 with Solaris 2.3 (using gcc)
  139.   o PC with SCO Open Desktop 3.0 (using gcc)
  140.   o Sun Sparc Classic with SunOS 4.1.3c
  141.   o HP 9000-710 with HP-UX 9.01
  142.   o PC 486DX2 with NetBSD 0.9
  143.  
  144.  
  145. I hope it will run on all other computers with X11R5.  If you managed
  146. to build the game on any other machine, please send me a short notice
  147. to the E-Mail adress below.
  148.  
  149. CREATING YOUR OWN LEVELS
  150.  
  151. An instruction to create your own levels is given in the file
  152. Levels.HOW
  153.  
  154. XBLAST SETUP
  155.  
  156. You have three possibilties when starting XBlast:
  157.  
  158.  o no commandline options and configuration via text interface
  159.  o configuration via commandline options
  160.  o NEW: tk/tcl script for a setup with  X Interface
  161.  
  162. To use the last one you need the Tcl and Tk script languages,
  163. which are avaiable at ftp.x.org in /contrib. This script
  164. is my first attempt in using tk/tcl, so there still
  165. can be some bugs in it.  To use it you have to edit file 
  166. xblast.tcl and change the following things
  167.  
  168.  o edit the path for the script interpreter "wish" in the first line
  169.    of the script
  170.  o edit the variable GAMEDIR to your xblast directory.
  171.  
  172. Then just type xblast.tcl and it should run.
  173.  
  174.  
  175. WHATS NEW IN V1.1
  176.  
  177.  o  Filename are changed to less than 15 char
  178.     (Required for X11R6 contrib)
  179.  
  180.  o  TWO new extra types:
  181.    - kicking bombs
  182.    - blast ALL bombs
  183.  
  184.  o  new shrinking feature for many levels
  185.    - the level starts shrinking after half the game time
  186.    - shrinking is more moderate than in Shrinking World
  187.  
  188.  o  extra conservation
  189.    - when a player dies, his extras are distributed
  190.      on the map
  191.  
  192.  o  bomb malfunction
  193.    - sometimes a bomb will take longer to explode.
  194.  
  195.  o  bugfix of a timing bug, which appeared under Solaris 
  196.     (this bugs makes the players run uncontrolable).
  197.  
  198.  
  199. THE FUTURE
  200.  
  201. The following things are planned for the future version
  202. (with absolutely NO WARRANTY that they will come):
  203.  
  204.  o  Full Color Support (not just only Black/White)
  205.  o  Saving/Loading setups with xblast.tcl
  206.  o  a better and more detailed guide howto build you own levels
  207.  o  more levels with new extras, graphics and monsters?
  208.  
  209. But don't expect any large changes before spring 1994. 
  210.  
  211.  
  212. BUGS
  213.  
  214. Known are the following:
  215.  
  216.  o  If the programm doesn't react to any keypress, move the mouse pointer
  217.     outside the window and then inside again.
  218.  
  219.  o  With certain X-Servers the control via number-pad doesn't work.
  220.     Try Num-Lock or  change your Xmodmap (This should be
  221.     fixed by now).
  222.  
  223. If you find any other bugs, please report them to
  224.  
  225. E-MAIL: vogel@ikp.uni-koeln.de
  226.  
  227.  
  228. CREDITS
  229.  
  230. SPECIAL UNIX CONSULTANT
  231. Norbert Nicolay
  232.  
  233. BETA TESTERS
  234. Eckhard Grah
  235. Rodi Herzberg
  236. Rolf Kuehn
  237. Norbert Nicolay
  238. Hajo Richter
  239.  
  240. SPECIAL THANX TO
  241.  o Cameron Gregory(cameron@cs.jcu.edu.au) for converting my README
  242.    into a manpage
  243.  o Henrik W. Nielsen(hwn@cci.dk) for his bugfix for the number-pad control.
  244.  o Jamie(be136@city.ac.uk) for his great idea of the extra, which
  245.    detonate ALL bombs (in the Halloween level) 
  246.  o Ian Jamison(ianj@melko.co.uk) for his bugfix of a timimg problem
  247.    with gettimeofday under Solaris 
  248.  
  249. THANX
  250. to all people, who send me an e-mail, that the programm runs on the their
  251. machine or just that the enjoyed the game.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.